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Installing  the  SAMeDL  Development  Environment  (SDE) 

The  SDE  installation  procedure  for  Unix  Environments  depends  on  the  distribution  media  you 
possess.  Please  follow  the  instructions  listed  for  your  media  to  ensure  proper  installation; 

Installing  the  SDE  from  3  and  1/2”  Floppy  Disks: 

(i)  su  log  on  as  a  super-user 

(ii)  mkdir  /usr/Iib/same  create  the  SAMeDL  installation  directory 

(iii)  cd  /usr/Iib/same  cd  to  the  new  directory 

(iv)  Insert  the  diskette  labeled  SAMeDL  Compiler  &  Environment ,  Disk  1  of  3  into 
the  the  first  floppy  drive. 

(v)  tar  xvf /dev/dsk/fOqlSdt  copy  SAMeDL  files  into  the  target  directory 

(vi)  Repeat  steps  (iv)  and  (v)  with  disks  2  and  3. 

(vii)  ^install  complete  the  installation 

(viii)  chmod  555  /usr/Iib/same  make  sure  the  SAMeDL  home  directory  is  readable 

(ix)  exit  exit from  the  super-user  shell 

The  example  directory  used  in  this  installation  guide  is  /usr/Iib/same.  You  do  not  have  to  install 
SAMeDL  into  this  directory.  To  install  SAMeDL  into  another  directory,  simply  execute  the 
instructions  above  using  your  chosen  directory  where  the  guide  refers  to  /usr/Iib/same. 

Installing  the  SDE  from  1/4”  Tape  Cartridge: 

(i)  su  log  on  as  a  super-user 

(ii)  mkdir  /usr/Iib/same  create  the  SAMeDL  installation  directory 

(iii)  cd  /usr/Iib/same  ,  cd  to  the  new  directory 

(iv)  Insert  the  tape  labeled  SAMeDL  Compiler  &  Environment,  Tape  1  of  1  into  the 
tape  drive. 

(v)  tar  xvf  /dev/rstO  copy  SAMeDL  files  into  the  target  directory 

(vi)  ^install  complete  the  installation 

(viii)  chmod  555  /usr/Iib/same  make  sure  the  SAMeDL  home  directory  is  readable 

(ix)  exit  exitjrom  the  super-user  shell 

The  example  directory  used  in  this  installation  guide  is  /usr/Iib/same.  You  do  not  have  to  install 
SAMeDL  into  this  directory.  To  install  SAMeDL  into  another  directory,  simply  execute  the 
instructions  above  using  your  chosen  directory  where  the  guide  refers  to  /usr/Iib/same. 
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Locating  the  SAMeDL  Compiler  and  Support  Packages 

After  the  installation  procedure  is  complete,  the  SDEPATil  environment  variable  should  be  set 
to  point  to  the  SAMeDL  installation  directory.  Frequent  users  of  SAMeDL  may  want  to  add  it  to 
their  Unix  search  paths  (consult  your  system  administrator  on  how  to  do  this).  The  SAMeDL 
installation  directory  should  contain  the  following  files: 


DEMO 

subdirectory  containing  the  SAMeDL  installation  demo 

STD_PKGS 

subdirectory  containing  the  SAMeDL  standard  packages,  including 
saniedl_std.sme  and  samedl_sys,sme  which  contain  the  SAMeDL 
packages  SAMeDL_Standard  and  SAMeDL_System  respectively. 

TESTS 

subdirectory  containing  the  SAMeDL  acceptance  tests. 

comp_std_pkgs 

Unix  C-shell  script  for  compiling  the  standard  packages 

install 

S AMeDL  installation  script 

samedl 

SAMeDL  Compiler  Executable 

sdexleanlib 

SDE  Module  Manager  Executable 

sdexreatar 

SDE  Module  Manager  Executable 

(Informix,  Oracle,  and  Sybase-targeted  compilers  only) 

sde.creatlib 

SDE  Module  Manager  Executable 

sde.ls 

SDE  Module  Manager  Executable 

sde.mkscript 

SDE  Module  Manager  Executable 

sde.purge 

SDE  Module  Manager  Executable 

sde.rm 

SDE  Module  Manager  Executable 

sde.rinlib 

SDE  Module  Manager  Executable 
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Performing  Additional  Setup  Procedures 

For  ease  of  use  in  accessing  the  SAMeDL  tools,  you  may  want  to  add  the  path  to  the  SAMeDL 
installation  directory  to  your  application  path,  or  you  may  want  to  set  the  environment  variable 
SDEPATH  to  point  to  the  installation  directory.  Neither  of  these  conditions  is  required  for 
normal  use  of  your  SAMeDL  toolset,  but  setting  of  the  SDEPATH  variable  is  required  for 
building  the  SAMeDL  demonstration  program  and  running  the  SAMeDL  acceptance  tests. 

Depending  on  which  DBMS  your  SAMeDL  compiler  is  compatible  with,  there  may  be 
additional  procedures  which  must  be  performed  in  order  to  prepare  the  DBMS  for  SAMeDL 
compatibility.  Please  check  below  in  case  your  version  of  SAMeDL  requires  additional 
installation- time  steps. 

Additional  Informix  Setup  Requirements 

As  part  of  the  Informix  installation  procedure,  certain  environment  variables  will  need  to  be  set. 
The  use  of  SAMeDL  requires  that  the  INFORMIXDIR  environment  variable  be  set  to  point  to 
the  Informix  installation  directory. (e.g.  /usr/Informix).  However,  setting  this  one  environment 
variable  may  not  be  enough  to  ensure  the  proper  use  of  the  DBMS.  It  is  important  that  all 
necessary  environment  variables  for  Informix  be  set  according  to  the  Informix  documentation 
recorrrmendations  prior  to  using  your  SAMeDL  tools. 

A<><litii9nal,Qrack.Sgtup-Requii:fim€nts 

The  Oracle  database  should  be  installed  according  to  the  manual.  In  addition,  in  preparation  for 
running  the  SAMeDL  acceptance  tests,  an  Oracle  user  test  with  password  test  should  be  created 
by  the  Oracle  database  administrator.  Access  to  the  test  account  should  be  enabled  for  the 
account  from  which  the  acceptance  tests  will  be  run  and  the  necess^  permissions  should  be 
granted  to  the  test  user  to  allow  table  creation.  As  a  simple  exercise,  invoke  the  Oracle  sqlplus 
command  and  enter  user  name  test  and  password  test  when  prompted.  If  Oracle  rejects  your 
login,  then  the  installation  demonstration  and  SAMeDL  acceptance  tests  will  not  run  properly 
from  your  account 

As  part  of  the  Oracle  installation  procedure,  certain  environment  variables  will  need  to  be  set. 
The  use  of  SAMeDL  requires  that  the  ORACLE_HOME  environment  variable  be  set  to  point 
to  the  Oracle  installation  directory  (e.g.  /usr/Oracle).  However,  setting  this  one  environment 
variable  may  not  be  enough  to  ensure  the  proper  use  of  the  DBMS.  It  is  important  that  all 
necessary  environment  variables  for  Oracle  be  set  according  to  the  Oracle  documentation 
recommendations  prior  to  using  your  SAMeDL  tools. 

Additional  Sybase  Setup  Requirements 

Sybase  should  be  installed  according  to  the  manual  except  that  during  the  SQL  Server 
configuration,  case  sensitivity  must  be  tumed-off.  Select  "Dictionary  order,  case  insensitive" 
as  the  collating  order.  SAMeDL  will  not  work  correctly  if  case  sensitivity  is  left  on. 

In  addition,  in  preparation  for  running  the  SAMeDL  acceptance  tests,  a  Sybase  user  test  with 
password  test  should  be  created  by  the  Sybase  database  administrator.  Access  to  the  test  account 
should  be  enabled  for  the  account  from  which  the  acceptance  tests  will  be  run  and  the  necessary 
permissions  should  be  granted  to  the  test  user  to  allow  table  creation.  As  a  simple  exercise, 
invoke  the  Sybase  isql  command  and  enter  user  name  test  and  password  test  when  prompted.  If 
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Sybase  rejects  your  login,  then  the  installation  demonstration  and  SAMeDL  acceptance  tests  will 
not  run  properly  from  your  account. 

As  part  of  the  Sybase  installation  procedure,  certain  environment  variables  will  need  to  be  set. 
The  use  of  SAMeDL  requires  that  the  SYBASE  environment  variable  be  set  to  point  to  the 
Sybase  installation  directory  (e.g.  /usr/Sybase).  However,  setting  this  one  environment  variable 
may  not  be  enough  to  ensure  the  proper  use  of  the  DBMS.  It  is  important  that  all  necessary 
environment  variables  for  Sybase  be  set  according  to  the  Sybase  documentation 
recommendations  prior  to  using  your  SAMeDL  tools. 

Additional  XDB  Setup  Requirements 

A  knowledgeable  XDB  user  can  configure  the  database  in  minutes.  All  that  is  required  is  that: 

•  Recovery  is  turned  on. 

•  Backward  logging  is  turned  on. 

•  Autocommit  is  turned  off. 

Even  if  you  are  unfamiliar  with  XDB,  the  fr  llowing  steps  will  configure  a  database  that  can  be 
used  to  run  the  acceptance  tests. 

(ii) 

(iii) 

(iv) 


(V) 


(Vi) 


(vu) 

(viii) 


(ix) 


cd  /usr/Iib/same 

setenv  XDBCFG  'pwd' 
Make  sure  XDBPATH  is  set. 

xdbconfig 


Any  directory  will  suffice..  You  must  have 
write  permission  for  this  directory. 

Set  the  configuration  environment  variable. 

(usually  setenv  XDBPATH  lusrixdb  is 
correct). 

running  this  command  will  create  the  XDB 
configuration  file 


At  this  point  you  may  be  prompted  for  the  XDB  TERMINAL  type. 

Select  the  first  terminal  choice  (1). 

Now  you  will  be  asked  where  to  place  the  database  and  the  configuration  file. 
Since  you  are  in  the  correct  directory 

Press  y  and  Enter  And  now  wait. 

Finally  the  XDB  CONFIGURATION  screen  appears. 

Press  function  key  F3  Turn  Recovery  on. 

Press  function  key  F6 

XDB  USER  PROFILE  screen  appears. 

Press  function  key  F8  Turn  on  Backward  log. 
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(x)  Press  function  key  F9 

XDB  MULTIUSER  OPTIONS  screen  appears. 

(xi)  Press  function  key  F2  Turn  off  Autocommit. 

You've  just  ct'nfigured  the  XDB  to  the  proper  settings.  To  exit  xdbconfig  press  the  Esc  key  6 
times  (a  single  escape  is  not  enough,  two  are  required  before  the  escape  is  recognized).  Pressing 
the  escape  key  a  couple  of  extra  times  won’t  cause  any  problems. 
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Verifying  the  Success  of  the  SAMeDL  Installation 

Included  with  the  SAMeDL  Development  Environment  is  a  demonstration  program  which  is 
easy  to  build  and  can  provide  an  example  of  SAMeDL  as  well  as  being  a  verification  of  correct 
system  installation.  The  demonstration  files  are  located  in  the  DEMO  subdirectory  of  the 
SAMeDL  installation  directory.  Directions  on  how  to  build  this  demo  are  given  below.  Since 
these  instructions  are  database-specific,  please  be  sure  to  follow  the  directions  pertaining  to  the 
appropriate  SAMeDL  configuration. 

The  scripts  used  to  build  the  demo  program  rely  on  access  to  the  DBMS  and  Ada  compiler  you 
are  using.  You  should  have  installed  the  Ada  compilation  system  and  added  the  path  to  the  Ada 
tools  to  your  unix  path  prior  to  attempting  to  build  the  SAMeDL  demonstration  program,  since 
the  scripts  will  not  work  if  they  cannot  find  the  ada  compiler  and  linker.  Also,  you  should  have 
installed  the  DBMS  and  set  any  necessary  environment  variables,  since  the  SAMeDL 
demonstration  cannot  be  built  without  access  to  the  DBMS  server  and  tools.  In  particular,  please 
make  sure  that  your  DBMS  server  is  up  and  running  prior  to  building  the  demonstration 
program. 

The  scripts  used  to  build  the  demonstration  programs  require  that  the  SDEPATH  environment 
variable  be  set  to  point  to  the  SAMeDL  installation  directory.  Use  the  Unix  setenv  command  to 
set  this  variable  prior  to  running  the  scripts. 

Building  the  SAMeDL  Demo  Program  using  the  Informix  RDBMS 

(1)  Make  sure  the  Informix  INFORMIXDIR  environment  variable  and  the  SAMeDL 
SDEPATH  environment  variable  have  been  set  to  point  to  the  Informix  and 
SAMeDL  installation  directories  (respectively). 

(2)  Copy  the  contents  of  the  DEMO  subdirectory  of  the  SAMeDL  installation  directory 
to  your  working  directory. 

(3)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build_recdb.  This  file  contains  commands  that  will  create  a  new  Informix  database 
called~recdb  and  one  table  called  members  using  the  Informix  isql  utility.  If  you  do 
not  have  access  to  this  utility  or  else  do  not  have  permission  to  create  databases  and 
tables  in  Informix,  then  this  script  will  not  work  and  you  should  consult  your  database 
administrator  to  be  granted  the  proper  Informix  permissions. 

(4)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build_demo.  This  file  contains  commands  that  will  compile,  link  and  invoke  the 
Ada-Informix  application  main,  which  inserts  and  retrieves  records  from  the  Informix 
database  recdb,  created  by  build_recdb. 

Building  the  SAMeDL  Demo  Program  using  the  Oracle  RDBMS 

(1)  Make  sure  the  Oracle  ORACLE_HOME  environment  variable  and  the  SAMeDL 
SDEPATH  environment  variable  have  been  set  to  point  to  the  Oracle  and  SAMeDL 
installation  directories  (respectively). 

(2)  Copy  the  contents  of  the  DEMO  subdirectory  of  the  SAMeDL  installation  directory 
to  your  working  directory. 
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(3)  From  inside  youi  working  directory,  invoke  the  Unix  C-shell  command  file 
build_recdb.  This  file  contains  commands  that  will  create  the  Oracle  table  called 
members  in  account  test  using  the  Oracle  sqiplus  utility.  If  you  do  not  have  access  to 
this  utility  or  else  do  not  have  permission  to  create  tables  in  Oracle,  then  this  script 
will  not  work  and  you  should  consult  your  database  administrator  to  be  granted  the 
proper  Oracle  permissions,  (see  the  section  on  Additional  Oracle  Setup 
Requirements) 

(4)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build  demo.  This  file  contains  commands  that  will  compile,  link  and  invoke  the 
Ada-(Jracle  application  main,  which  inserts  and  retrieves  records  from  the  Oracle 
database  created  by  buiId_demo. 

Building  the  SAMeDL  Demo  Program  u.sing  the  Svhase  RDBMS 
To  build  the  SAMeDL  demo,  follow  these  steps: 

(1)  Make  sure  the  Sybase  SYBASE  environment  variable  and  the  SAMeDL  SDEPATH 
environment  variable  have  been  set  to  point  to  the  Sybase  and  SAMeDL  installation 
directories  (respectively). 

(2)  Copy  the  contents  of  the  DEMO  subdirectory  of  the  SAMeDL  installation  directory 
to  your  working  directory.  ■ 

(3)  Create  an  Ada  library  using  a.mkUb  -i. 

(4)  Provide  WITH  directives  to  your  Ada  library  to  enable  the  proper  binding  of  your 
executable.  To  do  this,  use  the  a.info  -i  command  provided  with  your  VADS 
environment.  You  must  provide  a  WITH  directive  for  each  of  the  following  items,  in 
the  given  order: 

(a)  The  object  file  generated  by  the  call  samadl  in  the 
bulld_deino  script  (for  this  example,  samadl. lib /E_l.o) 

(b)  The  Sybase  library  .$SYBASE/llb/llbsybasql. a 

(c)  The  Sybase  library  ^SYBASE/llb/llbsybdb.a 

(d)  The  Unix  C  math  librairy  /usr/lib/llbm.a  (full  path  neune  may 

be  required) . 

Note:  for  (b)  and  (c),  VADS  may  require  that  the  full  path  name  be  given 
instead  of  the  reference  to  the  environment  variable  SYBASE. 

(5)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build_recdb.  This  file  contains  commands  that  will  create  the  Sybase  table  called 
members  in  account  test  using  the  Sybase  isql  utility.  If  you  do  not  have  access  to 
this  utility  or  else  user  test  does  not  have  permission  to  create  tables  in  Sybase,  then 
this  script  will  not  work  and  you  should  consult  your  database  administrator  to  be 
granted  the  proper  Sybase  permissions,  (see  the  section  on  Additional  Sybase  Setup 
Requirements) 

(6)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build_demo.  This  file  contains  commands  that  will  compile  and  link  the  Ada-Sybase 
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application  main,  which  inserts  and  retrieves  records  from  the  Sybase  database 
recdb. 

(7)  Execute  main  to  test  the  demo  program. 

Building  the  SAMeDL  Demo  Program  using  the  XDB  RDBMS 

(1)  Make  sure  the  XDB  XDBPATH  environment  variable  and  the  SAMeDL  SDEPATH 
environment  variable  have  been  set  to  point  to  the  XDB  and  SAMeDL  installation 
directories  (respectively). 

(2)  Copy  the  contents  of  the  DEMO  subdirectory  of  the  SAMeDL  installation  directory 
to  your  working  directory. 

(3)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build_recdb.  This  file  contains  commands  that  will  create  the  XDB  table  called 
members  in  the  database  pointed  to  by  the  XDBCFG  environment  variable  using  the 
xdbsql  utility.  If  you  do  not  have  access  to  this  utility  or  else  do  not  have  permission 
to  create  tables  in  XDB,  then  this  script  will  not  work  and  you  should  consult  your 
database  administrator  to  be  granted  the  proper  XDB  permissions,  (see  the  section  on 
Additional  XDB  Setup  Requirements) 

(4)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build  demo.  This  file  contains  commands  that  will  compile,  link  and  invoke  the 
Ada-X^DB  application'main,  which  inserts  and  retrieves  records  from  the  XDB 
database  created  by  buiId_demo. 

Note:  XDB  requires  a  configuration  file  in  order  to  operate.  (See  the  section  on  Additional 
XDB  Setup  Requirements) 
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Running  the  SAMeDL  Acceptance  Tests 

If  you  followed  the  steps  for  installing  SAMeDL  for  Interactive  Unix  you  will  have  also  installed 
the  SAMeDL  acceptance  tests.  The  tests  reside  in  the  subdirectory  TESTS. 

The  scripts  used  to  build  the  acceptance  tests  rely  on  access  to  the  DBMS  and  Ada  compiler  you 
are  using.  You  should  have  installed  the  Ada  compilation  system  and  added  the  path  to  the  Ada 
tools  to  your  unix  path  prior  to  attempting  to  run  the  SAMeDL  acceptance  tests,  since  the  scripts 
will  not  work  if  they  cannot  find  the  ada  compiler  and  linker.  Also,  you  should  have  installed  the 
DBMS  and  set  any  necessary  environment  variables,  since  the  SAMeDL  demonstration  cannot 
be  built  without  access  to  the  DBMS  server  and  tools.  In  particular,  please  make  sure  that  your 
DBMS  server  is  up  and  running  prior  to  building  the  demonstration  program. 

The  scripts  used  to  run  the  acceptance  tests  require  that  the  SDEPATH  environment  variable  be 
set  to  point  to  the  SAMeDL  installation  directory.  Use  the  Unix  setenv  command  to  set  this 
variable  prior  to  rurming  the  scripts. 

In  the  $SDEPATH/TESTS  subdirectory,  4  subdirectories  will  be  found.  The  Tl,  T2,  and  T3 
directories  contain  acceptance  test  code.  The  SRC  directory  contains  the  source  code  for  the 
SDE  Module  Manager.  For  more  information  on  this  code,  consult  the  file  readme.txt  in  the 
SRC  directory. 

The  procedures  for  running  the  SAMeDL  Acceptance  Tests  are  database-specific.  To  run  the 
tests,  please  consult  the  appropriate  section  on  the  following  pages. 
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Running  the  SAMeDL  Acceptance  Tests  using  the  Informix  RDBMS 

You  should  not  try  to  run  the  SAMeDL  acceptance  tests  until  both  the  Informix  RDBMS  and  the 
Alsys  Ada  compilation  system  have  been  properly  installed,  the  Informix  INFORMIXDIR 
environment  variable  has  been  properly  set  according  to  the  instructions  in  the  Informix  User's 
Manuals,  and  the  environment  variable  SDEPATH  has  been  set  to  point  to  the  SAMeDL 
installation  directory. 

To  run  the  acceptance  tests,  which  are  found  in  the  TESTS/Tl,  TESTS/T2,  and  TESTS/T3 
subdirectories  of  the  SAMeDL  installation  directory,  follow  these  simple  steps: 

Running  the  T1  tests: 

The  T1  test  procedure  consists  of  runrung  25  successful  tests  and  12  error  tests  through  the 
SAMeDL  compiler  and  then  compiling  the  result  interfaces  into  an  Ada  library.  The  T1 
acceptance  test  procedure  creates  a  large  ada  library.  Before  attempting  to  run  the  T1  tests,  you 
should  make  sure  that  the  Interactive  Unix  ULIMIT  value  is  set  to  a  value  high  enough  to 
accommodate  this  library  (a  ulimit  value  of  18000  should  be  sufficient). 

(1)  Copy  the  contents  of  the  TESTS/Tl  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  From  inside  your  working  directory,  invoke  the  Unix  C-sheU  conunand  file  build_tl. 
This  file  contains  commands  that  run  37  tests  through  the  SAMeDL  compiler  and 
then  compile  the  resulting  interface  files  into  the  ada  library  testlib,  creat^  by  the 
build_tl  command  file. 

(3)  To  verify  the  success  of  the  T1  test,  examine  the  files  in  your  working  directory  with 
the  extensions  .lis  and  .err. 

Running  the  T2  tests: 

The  T2  test  procedure  consists  of  compiling,  linking,  and  running  the  Ada-Informix  application 
test  drive,  which  populates  the  Informix  database  bank  and  then  performs  and  verifies  a  series 
of  SXjL  queries  on  the  database. 

(1)  Copy  the  contents  of  the  TESTS/T2  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build_bank.  This  file  contains  commands  that  will  create  a  new  Informix  database 
called  bank  and  five  tables  using  the  Informix  isql  utility.  If  you  do  not  have  access 
to  this  utility  or  else  do  not  have  permission  to  create  databases  and  tables  in 
Informix,  then  this  script  will  not  work  and  you  should  consult  your  database 
administrator  to  be  granted  the  proper  Informix  permissions. 

(3)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file  build_t2. 
This  file  contains  commands  that  will  compile,  link,  and  run  the  test_drive 
application. 

Note:  After  running  the  test_drive  application  once,  you  will  not  be  able  to  run  it  again  until 
the  Informix  bank  database  has  been  reset  to  its  initial  configuration  (all  tables  empty). 


14 


Intermetrics,  Inc. 


SAMeDL  Development  Environment  -  Installation  Guide  for  Unix 


Running  the  T3  tests: 

The  T3  test  procedure  consists  of  running  16  successful  tests  and  17  error  tests  through  the 
SAMeDL  compiler  and  then  compiling  the  result  interfaces  into  an  Ada  library.  TTie  T3 
acceptance  test  procedure  creates  a  large  ada  library.  Before  attempting  to  run  the  T3  tests,  you 
should  make  sure  that  the  Interactive  Unix  ULIMIT  value  is  set  to  a  value  high  enough  to 
accommodate  this  library  (a  ulimit  value  of  18000  should  be  sufficient). 

(1)  Copy  the  contents  of  the  TESTS/T3  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file  build_t3. 
This  file  contains  commands  that  >^1  run  33  tests  through  the  SAMeDL  compiler  and 
then  compile  the  resulting  interface  files  into  the  ada  library  testlib,  created  by  the 
build_t3  command  file. 

(3)  To  verify  the  success  of  the  T3  test,  examine  the  files  in  your  working  directory  with 
the  extensions  .lis  and  .err. 
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Running  the  SAMeDL  Acceptance  Tests  using  the  Oracle  RDBMS 

You  should  not  try  to  run  the  SAMeDL  acceptance  tests  until  both  the  Oracle  RDBMS  and  the 
Alsys  Ada  compilation  system  have  been  properly  installed,  the  ORACLE_HOME  (usually 
/usr/oracle)  environment  variable  has  been  properly  set  according  to  the  instructions  in  the 
Oracle  User's  Guide  and  the  environment  variable  SDEPATH  has  been  set  to  point  to  the 
SAMeDL  installation  directory. 

To  run  the  acceptance  tests,  which  are  found  in  the  TESTS/Tl,  TESTS/T2,  and  TESTS/T3 
subdirectories  of  the  SAMeDL  installation  directory,  follow  these  simple  steps: 

Running  the  T1  tests: 

The  T1  test  procedure  consists  of  running  25  successful  tests  and  12  error  tests  through  the 
SAMeDL  compiler  and  then  compiling  the  result  interfaces  into  an  Ada  library  --  no  executable 
is  produced.  TTie  T1  acceptance  test  procedure  creates  a  large  ada  library.  Before  attempting  to 
run  the  T1  tests,  you  should  make  sure' that  the  Interactive  Unix  ULEMIT  value  is  set  to  a  value 
high  enough  to  accommodate  this  library  (a  ulimit  value  of  18000  should  be  sufficient). 

(1)  Copy  the  contents  of  the’  TESTS/Tl  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  From  inside  your  working  directory,  invoke  the  C-sheU  command  file  build_tl.  This 
file  contains  commands  that  will  run  37  tests  through  the  SAMeDL  compiler  and  then 
compile  the  resulting  interface  files  into  the  Ada  library, 

(4)  To  verify  the  success  of  the  T1  test,  examine  the  files  in  your  working  directory  with 
the  extensions  .lis  and  .err. 

Running  the  T2  tests: 

The  T2  test  procedure  consists  of  compiling,  linking,  and  running  the  Ada-Oracle  application 
test_drive,  which  populates  the  Oracle  database  bank  and  then  performs  and  verifies  a  series  of 
SQL  queries  on  the  database. 

(1)  Copy  the  contents  of  the  TESTS/T2  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build_bank.  This  file  contains  commands  that  will  create  the  Oracle  tables  cust, 
saving,  branch,  loan,  and  cheque  in  account  test  using  the  Oracle  sqlplus  utility.  If 
you  do  not  have  access  to  this  utility  or  else  do  not  have  permission  to  create  tables  in 
Oracle,  then  this  script  will  not  work  and  you  should  consult  your  database 
administrator  to  be  granted  the  proper  Oracle  permissions,  (see  the  section  on 
Additional  Oracle  Setup  Requirements) 

(3)  From  inside  your  working  directory,  invoke  the  Unix  C-sheU  command  file  build_t2. 
This  file  contains  commands  that  will  compile,  link  and  invoke  the  Ada-Oracle 
application  test_drive,  which  inserts  and  retrieves  records  from  the  Oracle  database 
created  by  build^bank. 
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Note:  After  running  the  test_drive  application  once,  you  will  not  be  able  to  run  it  again  until  the 
Oracle  bank  database  has  been  reset  to  its  initial  configuration  (aU  tables  empty). 

Running  the  T3  tests: 

The  T3  test  procedure  consists  of  running  16  successful  tests  and  17  error  tests  through  the 
SAMeDL  compiler  and  then  compiling  the  result  interfaces  into  an  Ada  library.  TTie  T3 
acceptance  test  procedure  creates  a  large  ada  library.  Before  attempting  to  run  the  T3  tests,  you 
should  make  sure  that  the  Interactive  Unix  ULIMIT  value  is  set  to  a  value  high  enough  to 
accommodate  this  library  (a  ulimit  value  of  18000  should  be  sufficient). 

(1)  Copy  the  contents  of  the  TESTS/T3  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  From  inside  your  working  directory,  invoke  the  C-shell  command  file  bund_t3.  This 
file  contains  commands  that  will  run  33  tests  through  the  SAMeDL  compiler  and  then 
compile  the  resulting  interface  files  into  the  Ada  library. 

(3)  To  verify  the  success  of  the  T3  test,  examine  the  files  in  your  working  directory  with 
the  extensions  .lis  and  .err. 
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Running  the  SAMeDL  Acceptance  Tests  usint?  the  Sybase  RDBMS 

You  should  not  try  to  run  the  SAMeDL  acceptance  tests  until  both  the  Sybase  RDBMS  and  the 
Verdix  Ada  compilation  system  have  been  properly  installed,  the  SYBASE  (usually  /usr/sybase) 
environment  variable  has  been  properly  set  according  to  the  instructions  in  the  Sybase  User's 
Guide  and  the  environment  variable  SDEPATH  has  been  set  to  point  to  the  SAMeDL 
installation  directory. 

To  run  the  acceptance  tests,  which  are  found  in  the  TESTS/Tl,  TESTS/T2,  and  TESTS/T3 
subdirectories  of  the  SAMeDL  installation  directory,  follow  these  simple  steps: 

Running  the  T1  tests: 

The  T1  test  procedure  consists  of  running  25  successful  tests  and  12  error  tests  through  the 
SAMeDL  compiler  and  then  compiling  the  result  interfaces  into  an  Ada  library  ~  no  executable 
is  produced. 

(1)  Copy  the  contents  of  the  JESTS/Tl  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  Create  an  Ada  library  using  a.mklib  -i. 

(3)  From  inside  your  working  directory,  invoke  the  C-shell  command  file  build_tl.  This 
file  contains  commands  that  will  run  37  tests  through  the  SAMeDL  compiler  and  then 
compile  the  resulting  interface  files  into  the  Ada  library. 

(4)  To  verify  the  success  of  the  T1  test,  examine  the  files  in  your  working  directory  with 
the  extensions  .lis  and  .err. 

Running  the  T2  tests: 

The  T2  test  procedure  consists  of  compiling,  linking,  and  running  the  Ada-Sybase  application 
test_drive,  which  populates  the  Sybase  database  bank  and  then  performs  and  verifies  a  series  of 
SQL  queries  on  the  database. 

(1)  Copy  the  contents  of  the  TESTS/T2  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  Create  an  Ada  library  using  a.nikHb  -i. 

(3)  Provide  WITH  directives  td  your  Ada  library  to  enable  the  proper  binding  of  your 
executable.  To  do  this,  use  the  a.info  -i  command  provided  with  your  VADS 
environment  You  must  provide  a  WITH  directive  for  each  of  the  following  items,  in 
the  given  order: 

(a)  The  object  file  generated  by  the  call  samadl  in  the 
bulld_t2  script  (for  this  example,  8ainedl.lib/E_l.o) 

(b)  The  Sybase  library  $SYBASE/llb/llbsyb«8ql.a 

(c)  The  Sybase  library  $SYBASE/llb/llb8ybdb.a 
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(d)  The  Unix  C  math  library  /usr/lib/libm.a  (full  path  name  may 
be  required) . 

Note:  for  (b)  and  (c),  VADS  may  require  that  the  full  path  name  be  given 
instead  of  the  reference  to  the  environment  variable  SYBASE. 

(4)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build_bank.  This  file  contains  commands  that  will  create  the  Sybase  database  called 
bank  in  account  test  using  the  Sybase  isql  utility.  If  you  do  not  have  access  to  this 
utility  or  else  user  test  does  not  have  permission  to  create  tables  in  Sybase,  then  this 
script  will  not  work  and  you  should  consult  your  database  administrator  to  be  granted 
the  proper  Sybase  permissions,  (see  the  section  on  Additional  Sybase  Setup 
Requirements) 

(5)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file  build_t2. 
This  file  contains  commands  that  will  compile,  link  the  Ada-Sybase  application 
test_drive,  which  inserts  and  retrieves  records  from  the  Sybase  database  'recdb'. 

Note:  After  running  the  test_drive  application  once,  you  will  not  be  able  to  run  it  again 
until  the  Sybase  bank  database  has  been  reset  to  its  initial  configuration  (all  tables 
empty). 

Running  the  T3  tests: 

The  T3  test  procedure  consists  of  running  16  successful  tests  and  17  error  tests  through  the 

SAMeDL  compiler  and  then  compiling  the  result  interfaces  into  an  Ada  library. 

(1)  Copy  the  contents  of  the  TESTS/T3  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  Create  an  Ada  library  using  a.niklib  -i. 

(3)  From  inside  your  working  directory,  invoke  the  SunOS  4.1.1  C-shell  command  file 
build_t3.  This  file  contains  commands  that  will  run  33  tests  through  the  SAMeDL 
compiler  and  then  compile  the  resulting  interface  files  into  the  Ada  library. 

(4)  To  verify  the  success  of  the  T3  test,  examine  the  files  in  your  working  directory  with 
the  extensions  .lis  and  .err. 
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Running  the  SAMeDL  Acceptance  Tests  using  the  XDB  RDBMS 

You  should  not  try  to  run  the  SAMeDL  acceptance  tests' until  both  the  XDB  RDBMS  and  the 
Alsys  Ada  compilation  system  have  been  properly  installed,  the  XDB  XDB  PATH  (usually 
/usr/xdb)  environment  variable  has  been  properly  set  according  to  the  instructions  in  the  XDB 
User  Manuals,  and  the  environment  variable  SDEPATH  has  been  set  to  point  to  the  SAMeDL 
installation  directory. 

To  run  the  acceptance  tests,  which  are  found  in  the  TESTS/Tl,  TESTS/T2,  and  TESTS/T3 
subdirectories  of  the  SAMeDL  installation  directory,  follow  these  simple  steps: 

Running  the  T1  tests: 

The  T1  test  procedure  consists  of  running  25  successful  tests  and  12  error  tests  through  the 
SAMeDL  compiler  and  then  compiling  the  result  interfaces  into  an  Ada  library.  The  T1 
acceptance  test  procedure  creates  a  large  ada  library.  Before  attempting  to  run  the  T1  tests,  you 
should  make  sure  that  the  Interactive  Unix  ULIMIT  value  is  set  to  a  value  high  enough  to 
accommodate  this  Library  (a  ulimit  value  of  18000  should  be  sufficient). 

(1)  Copy  the  contents  of  the  TESTS/Tl  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file  build_tl. 
This  file  contains  commands  that  will  run  37  tests  through  the  SAMeDL  compiler  and 
then  compUe  the  resulting  interface  files  into  the  Ada  library  testlib,  created  by  the 
build_tl  command  file. 

(3)  To  verify  the  success  of  the  T1  test,  examine  the  files  in  your  working  directory  with 
the  extensions  .lis  and  .err. 

Running  the  T2  tests: 

The  T2  test  procedure  consists  of  compiling,  linking,  and  running  the  Ada-XDB  application 
test_drive,  which  populates  the  XDB  database  and  then  performs  and  verifies  a  series  of  SQL 
queries  on  the  database. 

(1)  Copy  the  contents  of  the  TESTS/T2  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file 
build_bank.  This  file  contains  commands  that  will  create  XDB  tables  called  cust, 
cheque,  branch,  loan,  and  savings  in  the  database  pointed  to  by  the  XDBCFG 
environment  variable  using  the  xdbsqi  utility.  If  you  do  not  have  access  to  this  utility 
or  else  do  not  have  permission  to  create  tables  in  XDB,  then  this  script  will  not  work 
and  you  should  consult  your  database  administrator  to  be  granted  the  proper  XDB 
permissions,  (see  the  section  on  Additional  XDB  Setup  Requirements) 

(2)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file  build_t2. 
This  file  contains  commands  that  will  compile,  link,  and  run  the  test_drive 
application. 
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Note:  After  running  the  test_drive  application  once,  you  will  not  be  able  to  run  it  again  until 
the  XDB  database  has  been  reset  to  its  initial  configuration  (all  tables  empty). 

Running  the  T3  tests: 

The  T3  test  procedure  consists  of  running  16  successful  tests  and  17  error  tests  through  the 
SAMeDL  compiler  and  then  compiling  the  result  interfaces  into  an  Ada  library.  The  T3 
acceptance  test  procedure  creates  a  large  ada  library.  Before  attempting  to  run  the  T3  tests,  you 
should  make  sure  that  the  Interactive  Unix  ULIMIT  value  is  set  to  a  value  high  enough  to 
accommodate  this  library  (a  ulimit  value  of  18000  should  be  sufficient). 

(1)  Copy  the  contents  of  the  TESTS/T3  subdirectory  of  the  SAMeDL  installation 
directory  to  your  working  directory. 

(2)  From  inside  your  working  directory,  invoke  the  Unix  C-shell  command  file  build_t3. 
This  file  contains  commands  that  run  33  tests  through  the  SAMeDL  compiler  and 
then  compile  the  resulting  interface  files  into  the  ada  library  testlib,  created  by  the 
build_t3  command  file. 

(3)  To  verify  the  success  of  the  T3  test,  examine  the  files  in  your  working  directory  with 
the  extensions  Jis  and  .err. 
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Release  Notes  for  the  SAMeDL  Development  Environments 

The  release  notes  for  the  SAMeDL  Development  Environments,  version  2.8,  are  included  on  the 
following  pages.  The  release  notes  contain  information  specific  to  the  SDE  Release  regarding 
the  appropriate  system  configuration  for  the  SDE  and  any  implementation-dependent  features 
included  in  the  release. 

Version  2.8  (Informix/PC-386/Interactive  Unix/AIsys) 

System  Configuration 

The  Informix-targeted  version  2.8  of  the  SAMeDL  Development  Environment  is  designed  to  run 
in  conjunction  with  the  following  hardware  and  software  configuration; 

Machine;  PC  386 

Operating  System:  Interactive™  Unix,  Version  3.2.2 

Ada  Compiler:  Aisys  Ada,  Version  5.1.1 

Database  Management  Informix-OnLine  Database  Engine,  Version  4. 10 

Informix  ESQL/'"'  Host  Language  Interface,  Version  4.10 
Informix-SQL,  Version  4.10 

In  addition.  Intermetrics  recommends  the  following  Interactive  Unix  kernel  parameter  settings: 


DEFAULT 

MIN 

MM. 

MAXUMEM 

8192 

2560 

8192 

ULIMir 

-  18000 

2048 

4194303 

Implementation  Dependent  Features 

The  Informix-targeted  version  2.8  of  the  SAMeDL  Development  Environment  currently  supports 
the  following  implementation  dependent  features  of  the  SAMeDL  language  suggested  in  the 
noted  sections  of  the  SDE  LRM: 

LRM  Section  Language  Feature _ 

[2.6]  reserved  word  :;= 

connect 

[4.1.13]  word_list  ::= 

context  clause  I 

null  value  I 

null_bearing  assign  I 

not_null_bearing  assign 

The  semantics  of  the  implementation  defined  base  domain  options  provided  via  the 
word_list  grammar  are  explained  in  the  SDE  LRM,  section  4. 1.1. 3. 
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[5.3] 


extended  statement  ;;= 

connect  database_name  I 

database_riame  ::= 

character_literal  I 

constant_reference  I 

input_param_ref 

The  semantics  of  the  extended  statements  are  described  in  section  6.2  of  the  SDE 
User's  Guide. 
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Version  2.8  (Oracle/PC-386/Interactive  Unix/Alsys) 

System  Configuration 

The  Oracle-targeted  version  2.8  of  the  SAMeDL  Development  Environment  is  designed  to  mn  in 
conjunction  with  the  following  hardware  and  software  configuration; 

Machine:  PC-386 

Operating  System:  Interactive  Unix,  Version  2.1 

Ada  Compiler:  Alsys  Ada,  V ersion  5.1.1 

Database  Management:  Oracle  Database  Engine,  Version  6.0 

Oracle  Pro*C,  Version  60 

Oracle  SQLPlus  (Interactive  SQL  interface).  Version  6.0 
In  addition.  Intermetrics  recommends  the  following  Interactive  Unix  kernel  parameter  settings: 


DEFAULT 

MIN 

MAX 

MAXUMEM 

8192 

2560 

8192 

ULIMIT 

18000 

2048 

4194303 

Implementation  Dependent  Features 

The  Oracle-targeted  version  2.8  of  the  SAMeDL  Development  Environment  currently  supports 
the  following  implementation  dependent  features  of  the  SAMeDL  language  suggested  in  the 
noted  sections  of  the  SDE  LRM: 

LRM  Section  Language  Feature _ 

[2.6]  reserved  word  ::= 

connect 

[4.1.13]  word_list  ::= 

context  clause  I 

null  value  I 

null_bearing  assign  I 

not_null_bearing  assign 

The  semantics  of  the  implementation  defined  base  domain  options  provided  via  the 
word_list  grammar  are  explained  in  the  SDE  LRM,  section  4. 1.1.3. 

[53]  extended  statement  ::= 

connect  server  user_id  password  [  using  database_name  ] 

database_namc  ::= 

limited_valuc_spec 


Intermerrics,  Inc. 


25 


SAMeDL  Development  Environm^.J  -  Installation  Guide  for  Unix 


user_id  ::= 

limited_value_spec 

password-:;= 

limited_value_spec 

limited_value_spec  ::= 

character_literal  I 

constant_reference  I 

input_param_ref 

The  semantics  of  the  extended  statements  are  described  in  section  6.2  of  the  SDE 
User's  Guide. 


26 


Intermetrics,  Inc. 


SAMeDL  Development  Environment  -  Installation  Guide  for  Unix 


Version  2.8  (Sybase/Sun-Sparc/SunOS/Verdix) 

System  Configuration 

The  Sybase-targeted  version  2.8  of  the  SAMeDL  Development  Environment  is  designed  to  run 
in  conjunction  with  the  following  hardware  and  software  configuration: 

Machine:  Sun4 

Operating  System:  SunOS,  Version  4.1.1 

Ada  Compiler:  Verdix  Ada,  Version  6.0.3c 

Database  Management:-  Sybase  Database  Engine,  Version  4.8 

Sybase  Embedded  SQL/C  Host  Language  Interface, 

Version  4.8 

Sybase  SQL  (Interactive  SQL  interface).  Version  4.8 

Impkmentation  Pepffldgnt  Features 

The  Sybase- targeted  version  2.8  of  the  SAMeDL  Development  Environment  currently  supports 
the  following  implementation  dependent  features  of  the  SAMeDL  language  suggested  in  the 
noted  sections  of  the  SDE  LRM; 

LRM  Section  Language  F^tture _ 

[2.6]  reserved  word  ::= 

connect 

[4.1.U]  word_list  ::= 

context  clause  I 

null  value  I 

null_bearing  assign  I 

not_nuil_bearing  assign 

The  semantics  of  the  implementation  defined  base  domain  options  provided  via  the 
word_list  grammar  are  explained  in  the  SDE  LRM,  section  4.1. 1.3. 

[SJ]  extended  statement  ::= 

connect  database_name  I 

connect  server  user_id  password  I 

release  all 

database_name  ::= 

character_Uteral  I 

constant_reference 

uscrjd  ::= 

limited_value_spec 

password  ::= 
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limited_value_spec 

limited_value_spec  ::= 

character_literal  1 

constant_reference  1 

input_param_ref 

The  semantics  of  the  extended  statements  are  described  in  section  6.2  of  the  SDE 
User's  Guide. 
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Version  2.8  (XDB/PC-386/Interactive  Unix/Alsys) 

System  Configuration 

The  XDB-targeted  version  2.8  of  the  SAMeDL  Development  Environment  is  designed  to  run  in 
conjunction  with  the  following  hardware  and  software  configuration: 

Machine:  PC  386 

Operating  System:  Interactive™  Unix,  Version  3.2.2 

Ada  Compiler:  Alsys  Ada,  Version  5.1.1 

Database  Management:  XDB  2.3+  (This  is  not  a  commercial  version.  It  has  been 

*  upgraded  by  CA) 

In  addition.  Intermetrics  recommends  the  following  Interactive  Unix  kernel  parameter  settings: 


DEFAUIT 

MIN 

MAX 

MAXUMEM 

8192 

2560 

8192 

ULIMIT 

18000 

2048 

4194303 

Implementation  Dependent  Features 

The  XDB-targeted  version  2.8  of  the  SAMeDL  Development  Environment  currently  supports  the 
following  implementation  dependent  features  of  the  SAMeDL  language  suggested  in  the  noted 
sections  of  the  SDE  LRM: 

LRM  Section  Language  Feature _ 

[2.6]  reserved  word  ::= 

connect 

[4.1.1.3]  word_list  ::= 

context  clause  I 

null  value  I 

null_bearing  assign  I 

not_nuil_bearing  assign 

The  semantics  of  the  implementation  defined  base  domain  options  provided  via  the 
word_list  grammar  are  explained  in  the  SDE  LRM,  section  4.I.I.3. 

[5  J]  extended  statement  ::=  connect 

The  semantics  of  the  extended  statements  are  described  in  section  6.2  of  the  SDE 
User's  Guide. 

Using  NFS  Mounted  Disks  for  the  SAMeDL  Library 

The  SAMeDL  Development  Environment  works  well  with  NFS  mounted  disks  with  a  singular 
exception:  deletion  of  a  library  via  sde.rmlib.  The  contents  of  the  library  are  removed,  however. 
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the  directory  remains.  The  directory  is  not  removed  due  to  temporary  files  created  by  NTS.  The 
solution  is  to  use  rmdir  at  command  prompt  after  issuing  the  sde.rmlib  command. 
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